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ABSTRACT 


In recent years, many graphical approaches have been proposed to lift the 
inconvenience of text-based query language among end-users. The new query 
language called DFQL (DataFlow Query Language) is a fully graphical interface to 
the relational model based on a dataflow paradigm. It only requires users to connect 
some well-defined operators which have been given an equivalent one-to-one 
correspondent functionality (or construct) in traditional query language (SQL in this 
case). All of the power of current query languages and sufficient expressive power 
and functionality are retained. But some shortcomings of DFQL user interface still 
exist. 

This thesis is to introduce a more ease-to-use and ease-to-learn user interface, 
so the shortcomings we found in DFQL user interface can be lifted and the 
productivity and power of the new version of DFQL can be increased. We have 
adopted object-oriented programming approach in our implementation and the 
benefits of using object-oriented programming in our development are also 


discussed. 
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I. INTRODUCTION 


A. BACKGROUND 

In the past twenty years, relational database management systems have been 
accepted extensively for database implementation. To interact with a database, users 
of a database management system such as Ingres develop application programs by 
embedding a data manipulation language(e.g., ESQL) in a regular programming 
language(e.g., C). But those specialized text-based languages are somewhat 
unfriendly to inexperienced end-users (Codd, 1988) (Codd, 1990, chpt.23). In recent 
years, many graphical approaches have been introduced to lift the inconvenience 
among end-users (Wu, 1991) (Wu, 1986) (Wong, 1982) (Zloof, 1977) (Miyao, 
1986). 

A new query language called DFQL (DataFlow Query Language) was proposed 
in (Wu, 1991). DFQL is a fully graphical interface to the relational model based on 
a dataflow paradigm. Instead requiring users to use traditional text-based query 
language, DFQL only require users to connect some well-defined operators which 
have been given an equivalent one-to-one correspondent functionality (or construct) 
in traditional query language (SQL in this case). All of the power of current query 
languages and sufficient expressive power and functionality are retained. With an 
easy to use facility for extending the language, users are allowed to define their own 
user-defined operators by encapsulating existing primitive operators and/or 
user-defined operators previously defined by users. The user-defined operators 
become part of DFQL but can also be deleted from DFQL if they are thought of to 


be no good to exist. 


As have been presented previously in other papers (Angelaccio, 1990 and 
Sckut, 1991), the following goals are met in DFQL: 


° Employ a fully graphical environment as an user friendly interface 
to the database. 


e Sufficient expressive power and functionality, including relational 
completeness. 


° Ease-of-use in learning, remembering, writing and reading the 
language's constructs. 


° Consistency, predictability, and naturalness (in both syntax and 
function). 


° Simplicity and conciseness of features. 
° Clarity of definition, lack of ambiguity. 


° Ability to modify existing queries to form new _ queries 
incrementally. 


° High probability that users will write error-free queries. 


° Operator extensibility--allow the user to create new operators in 
terms of existing ones, analogous to defining a function in a 
programming language. 


Partial implementation of DFQL was done in (Clark, 1991). This thesis 
improves some shortcomings in Clark’s implementation. For example, as you can 
see in (Clark, 1991), a new operator always be created at the upper left corner of the 
drawing area. There is no way to create an operator by directly typing at wherever 
users like it to be. After being created, users are required to drag the operator to a 
new location where it 1s supposed to be. Several tedious steps of operation are 
required to simply delete an existing operator. Without creating an operator in the 


drawing area first, no on-line help message about this operator can be get. After 


users saved the help message of a new user-defined operator, the content of the help 
message can not be changed. So, should the help message of an user-defined 
operator need to changed, the only way to do is to delete the operator permanently 
and then redefined it and type in the help message carefully without any more 
mistake. No more than one DB INTEFACE window (an interface window in which 
users construct queries) are allowed at the same time is also a severe limitation of 
productivity to DQFL. If more than one DB INTERFACE window is allowed to 
exist at the same time then the reference to other existing queries may be more 
convenient during the construction of a new query. There are some more 
shortcomings which we will discuss in later chapter can be improved. All of these 
drawbacks increase users’ Overhead to construct a query and limit the productivity 
SE DFOL. 

The main concern of our new development of DFQL as we will discuss in the 
later chapters is to introduce a more ease-to-use and ease-to-learn user interface, so 
the shortcomings we found in Clark’s DFQL interface need to be lifted in order to 
reduce the overhead of the construction of queries. We believe that some features 
also need to be incorporated into the new DFQL so that the performance can be 
improved and the productivity and power of the new version of DFQL can be 
increased. For example, instead of rigidly creating a DFQL object at the upper left 
corner of the drawing area of the query window, users should be allowed to create a 
new DFQL object simply by clicking the mouse anywhere in the drawing area and 
entering the text night on the screen. Multiple DB INTERFACE window (in fact, 
as you will see that in our new DFQL, DB INTERFACE window is replaced with 


Query Window) and modification of the on-line help messages of existing user- 
defined operators are allowed. 

Since the interest of this thesis is focused on the user interface, the method of 
intermediate code generation and linkage to the existing backend database 
management system (DBMS) is not covered. For those who are interested in this 


issue can consult (Clark, 1991). 


B. OBJECTIVES 

. We started from the human factor aspects and utilized the techniques of object- 
oriented programming. Since, as stated in last section, the main concern of our new 
development of DFQL is to introduce a more ease-to-use and ease-to-learn user 
interface the following interface principles (Wu, 1990) are to be met: 


° Interface Principle 1: Be able to provide more information when 
asked. 


° Interface Principle 2: Be able to display multiple information at the 
same time. 


° Interface Principle 3: Be able to recover from the unintended or 
erroneous operation. 


° Interface Principle 4: Be able to perform the same operation in more 
than one way. 


° Interface Principle 5: Be able to prevent severe problem from 
happening. 


¢ Interface Principle 6: Be able to prevent modifications that are not 
supposed to be made. 


We'd also like to discuss some important features and benefits of object- 


oriented programming such as reusability, message passing, responsibility driven, 


inheritance, polymorphism, etc. we utilized in our implementation and present some 


experiences and lessons we learned during the development of our new DFQL. 


C. OVERVIEW 

Chapter II describes the concepts of the previous DFQL user interface done 
by Gard J. Clark, The concepts of our new DFQL is basically the same with those 
introduced in this chapter. We also discuss the details of how shortcomings we found 
in the previous DFQL interface can be improved. 

Chapter III describes our new DFQL user interface and introduces some 
important features which we have added to the new version of DFQL. The human 
factors analysis of this new interface, and how the interface principles we mentioned 
in last section are met is also covered in this chapter. 

Chapter IV presents a brief introduction to the programming language we use - 
- Prograph and describes why we have adopted the object-onented approach and 
evaluates the object-oriented design of our new DFQL user interface 
implementation and the benefits of class, message passing and some other features 
of object-oriented programming technique. 

Chapter V describes some important lessons we have learned during the 
development of the new DFQL interface. A summary of this thesis 1s also given in 


this chapter. 


II. PREVIOUS DFQL INTERFACE 


A. CONCEPTS 

As its name says, DFQL is a DataFlow Query Language. Queries are defined 
by the user connecting the desired objects graphically in the drawing area of a query 
window. Upon completion of a graphically constructed query, the query can be 
translated to the equivalent text-based SQL query by the DFQL interpreter and sent 
off to the backend database management (DBMS) for execution. After execution, 
the results will then be sent to the Query Results Window displaying on the 
computer screen. 

Two categories of objects are defined in DFQL interpreter: DFQL operators 
and text objects. Data are flowing from one operator to another along the query. 
Text objects are used as input data only, so there is no data flowing in to a text object. 
Operator execution is controlled by the presence of the input data for that operator. 


When all the data required become available the operator may execute or fire. 


1. DFQL Operators 

There are two categories of operators defined in DFQL interpreter: 
primitive operators and user-defined operators. An user-defined operator is one 
that has been constructed by the user from primitive operators and possibly other 
previous created user-defined operators. So we can say that an user-defined operator 
is a compact query with some essential input data unspecified. 

All operators in both categories except operators DISPLAY and 
SDISPLAY (we will mention them later) have the same appearance. A sample 
operator named select is shown in Figure II.1 below. Each operator is made up of 


three components: the body with the name of the operator, the input nodes and the 


— input nodes 
ry 


body with select 
as 1ts name 





Output node 


Figure II.1 Operator Construction 


output node. They can have multiple input nodes but there is only one output node 
for each operator. 

The body of the operator is the rounded-rectangle with the input nodes and 
output node attached to it. The input nodes and output node are represented by small 
circles. The input nodes are where the data from other operator or text object flowing 
into or fed into the operator.The output node is where the result of the execution of 
this operator flowing out of the operator. The intermediate result of a operator may 
then be passed to other operator(s) by connecting the operator’s output node to other 
operator's input node(s). An output node can be connected to multiple input nodes 
whereas an input node can only be connected to exactly one output node. The output 
from each operator is always a relation. 

The appearance of operators DISPLAY and SDISPLAY is shown in Figure 


II.2. We are intended to make them different from other operators because as we will 


Figure II.2 Construction of DISPLAY and SDISPLAY 


see later that these two operators are not provided to execute query functions but to 
allow user to print the contents of relations on the computer screen. They create no 


results. 


a. Primitive DFQL operators 
There are fifteen DFQL primitive operators provided in DFQL 
interpreter. Among them, there are six basic operators. These six primitive DFQL 
operators and a corresponding translation into SQL are shown in Figure II.3. The 


other primitive operators are shown in Figure I1.4. 


b. User-Defined Operators 
With user-defined operators, users can construct their own operators for 
situations that are unique to their query needs and give those new defined operators 
names that reflect the functions they perform. For example, instead of creating a 
query as shown in Figure II.5, we can define an operator sel-project and construct 


the query as shown in Figure II.6, where operator sel-project is defined by 
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Figure I1.3 DFQL Basic Operators 
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Figure I1.4 Other DFQL Operator 
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combining primitive DFQL operators select and project. We will discuss how to 


define an user-defined operator. 


student gpa>s.s 





Figure II.5 A Sample Query 
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Figure I1.6 An User-Defined Operator 
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The most significant advantage gained from the utilization of user- 
defined operators is that abstraction of complicated queries into a single user- 
defined operator is allowed. This make it easier to understand and use operators 


correctly. It also conserves space of the drawing area in the query window. 


2. Text Objects 
A special notation 1s used to provide textual input to the DFQL operators. 
Text entered by the user shows up in the query window as an object with the text 


attached to an output node as shown in Figure II.7. The text object can be interpreted 


A Text Object 
naa 


Figure II.7 Text Object 


in two different ways. If the text is the name of a relation, the output at the root can 
be thought of as an instance of that specific relation. If the text represents a 
condition, a list attributes, or some other textual input to another DFQL operator, 


then the text is passed on to that operator as a textual argument. 


3. DFQL Query Construction 
All DFQL queries exist as a dataflow program in which text objects and 
operators are connected by dataflow paths. The data flow paths are represented as 


the lines in the DFQL query that connect the input and output nodes of the DFQL 


te 


objects. Execution of the query can be visualized as flowing from the top of the 
diagram to the bottom. When the input arguments to an operator are available, that 
operator may execute, or fire, producing its output which will then flow on to the 
other connected operators. Since text objects have no inputs, they may fire at any 
time. Execution of the query continues until all input has been exhausted. The 
general idea behind DFQL query construction have been presented in (Clark, 1991). 
Instead of getting into all the details, we give an sample query as shown in Figure 


I1.8 below. 
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Figure II.8 A Sample Query 


This query uses the diff operator to return the IID of instructors in CS 
department whose pay is lower than 50,000 dollars. In this query the user-defined 


operator sel-project from Figure II.6 is used. 


B. SHORTCOMINGS OF THE PREVIOUS DFQL INTERFACE 
The previous DFQL interface as shown in Figure II.9 is made up of a DB 
INTERFACE window and a menu with eight menu items. The DB INTERFACE 


= File Edit Primitives UserOps Options... Info Special 
aaa SSS DB INTERFACE 





Figure II.9 DB INTERFACE 


window is the main interface from which users can construct their queries. The 
description of these components can be find in (Clark, 1991). We just present some 


shortcomings we found in it and discuss what we can do about them. 


1. Tedious Query Construction 
The most significant drawback in the Clark’s DFQL interpreter is the way 
to create an object in the DB INTERFACE window. Every time an object's button 
(either DFQL operator or text object) on the left portion of the DB INTERFACE 
window 1s clicked or an item (operator's name) from menu item Primitives of the 


main menu (Figure II.10) is selected, DFQL always creates it on the very upper left 
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Figure II.10 Primitives Menu 


corner of the drawing area in the DB INTERFACE window (Figure II.11, an 
operator named union is created in the DB INTERFACE). In order to put it on the 


right place where the object is supposed to be, the user need to click the object and 
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Figure II.11 Creation of an Operator 


drag it. But if the checkable menu item Select in the Edit menu (Figure IT.12) is 
checked then all of sudden, when the user click the object in order to drag it, she(he) 
will find that instead of dragging it, the object's color is converted,i.e., the object is 
selected to be deleted or deselected. So the user need to uncheck, or turn off Select 
and then drag the object. Figure II.13 shows a selected operator 

Not being able to create a text object by directly typing on the drawing area 


is another drawback. So we believe that allowing the user to locate the exact location 
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Figure 11.12 Edit Menu 





wan 


Figure IJ.13 A Selected Operator 


for the next object by simply clicking anywhere in the drawing area and then typing 
in the text or an existing Operator's name directly will ease the user's duty. 
To create an user-defined operator in the drawing area, an awkward process 


requires the user to select the menu item Select from menu UserOps (Figure IT.14) 
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and selects the specific user-defined operator from a dialog box (Figure 
II.15).Allowing the user-defined operators to be created the same way as primitive 


operators are would be a better solution. We will see how this procedure can be eased 


in our new implementation. 
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Figure II.14 UserOps Menu 
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Figure II.15 Dialog Box for User-Defined Operator Selection 


2. Tedious Delete Operation 
To delete an object from the drawing area of the DB INTERFACE 
window, the user also need to check, or turn on Select first and then select the menu 
item Delete from menu Edit. To make the delete operation easier, we will point out 
another way to delete objects without to check Select first. That is to say that Select 
is no longer needed in our new implementation of DFQL interpreter and can be 


remove. 


3. No Concurrent Query Constructions 
No more than one DB INTEFACE window are allowed at the same time is 
also a severe limitation of productivity to DQFL. If more than one DB 
INTERFACE window is allowed to exist at the same time then the reference to 
Other existing queries may be more convenient during the construction of a new 
query and users are also able to construct multiple queries in different windows at 


the same time. 


4. Rigid User Operator Definition 

To create a new user-defined operator, previous DFQL disables the object 
creation and deletion abilities. So the desired internal structure for the new user- 
defined operator must be exist in the drawing area before getting into the operator 
definition mode. This means that if the user want to define a new operator during the 
process of query construction, he (she) needs to delete some operators unneeded in 
the structure of the new operator. While in the operator definition mode, if the user 
find that some operators need to be added to or deleted from the internal structure of 
the new operator being constructed, he(she) need to give up all the efforts done 


before and return to the query construction mode then add or delete some operators. 
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We believe that all the object creation and deletion abilities should be retained in 
operator creation mode so the user does not need to go back and forth between query 


construction and operator definition modes. 


5. Reference Information Exit Too Short 
After viewing the internal structure of an user-defined operator, the window 
in which the internal structure of the user-defined operator is displayed need to be 
closed before the user can proceed to do other stuff. The window and its contents are 
not allow to stay available. This means that every ttme when the user need to view 
the internal structure of an user-defined operator, the viewing procedure need to be 


repeated. This 1s also a drawback needed to lifted. 


6. Restricted Way of Getting Help 

The previous DFQL provides help information describing each operator by 
requiring the user to double-click on an operator existing in the drawing area. This 
is the only way to get the information of an operator. So it 1s impossible for an user 
to get the information of any operator before it is created in the drawing area. But it 
is always the case that users need to consult the help messages of operators from 
time to time, especially for user-defined operators. This need is more obvious when 
the number of user-defined operators gets larger. So when users are not really sure 
what the functionality of an operator they may want to use is, we can not expect 
them to tolerate the inconvenience of creating an operator, double clicking it to get 
the help message, finding out that it is not what exactly they want and then go 
through the same procedures again to try other operators.We will added some more 


features of on-line help to our new DFQL interface. 
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Il]. NEW DFQL INTERFACE 


Like the previous DFQL, new DFQL is also implemented on an Apple 
Macintosh. Basic operations of this implementation depend heavily on use of the 
mouse and pull-down menus. In this section we present an detailed discussion on 


how the user interacts with the DFQL interpreter to construct and execute queries. 


A. STARTING THE PROGRAM 

Upon start-up, the user 1s presented with the screen shown below as Figure III.1. 
We do not use DB INTERFACE as the title of the main window, instead, we use 
Query Window followed by an number indicating the sequential order. That is 
because we allow multiple Query Windows to exist at the same time in our new 
DFQL. So what we see upon start-up 1s a main window entitled Query Window I 


along with a pull-down menu. 


B. QUERY WINDOW AND ITS ITEMS 
A Query Window as shown in Figure II.] can be moved, resized, closed and 
roomed by utilizing the basic functions of Apple Macintosh. We assume that readers 


are all aware of those functions. 


1. Buttons 
The Run button executes the query which 1s currently constructed in the 
drawing area. Run will first check that the query is correctly constructed. Then the 
query will be sent off to the backend DBMS for processing. Query results returned 
from the database will be displayed in a separate Query Result Window (Figure 


111.2). We will mention Query Result Window later. 


Query Window main menu 
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Figure II¥.1 Query Window 
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Figure III.2 A Query and its Query Results Window 
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The New button creates a new Query Window N, where N is the number 
indicating that this is the Nth Query Window opened since the start-up of the DFQL 
interpreter. When a new Query Window is opened, a query filename Untitled #N, 
where N is the same number as that in the title of the Query Window. All Query 
Windows retains all capabilities as the first one does. By creating new Query 
Windows, the user is allow to construct queries in different Query Windows 
concurrently. This feature make the DFQL more productive. 

The Open button allows the user to retrieve a previously saved query file 
from disk. When Open is clicked, a dialog box is presented from which the user can 
select the stored query file for retrieval. Before a selected query file can be retrieved 
onto a Query Window, DFQL will check if it has been opened in any Query Window 
or if there is any query with the same file name exists in any Query Window. If this 
situation is true, then DFQL will prompt a message telling the user that in which 
Query Window the query file selected has been opened. This feature agrees with 
Interface Principle 5: Be able to prevent severe problem from happening. If the 
selected query file has not been opened, it is immediately retrieved onto the Query 
Window and the query (the content of the newly opened file) appears in the drawing 
area. The previous filename assigned to the Query Window will be replaced by the 
new one. 

The Save button stores the current query onto disk with the name that is 
currently assigned to the query. The Save as button allows the user to store the 
cuirent query with a new name. When Save as is clicked, a file naming dialog box 
displayed. The user can enter the new file name for the current query to be saved. If 


the entered file name matches an existing file in any Query Window, the user will be 
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prompt that a file with this name is currently opened in a specific Query Window and 
the save operation is abandoned and the file naming dialog box appears again asking 
the user to enter a new filename. On the other hand, if the entered filename matches 
an existing file in the disk, the user will be asked whether or not he(she) really want 
to replace the previous stored file. If not, the user can either abandon the saving 
attempt or enter a new name. When an appropriate name has been given the query 
will be saved to disk. 

The Reset button clears the current query from the drawing area and from 
the computer's memory. When the user has no desire to save the current query, Reset 
can be used to set up a new query. This is also a shortcut to delete all objects in the 
drawing area and give the user a blank drawing area to start constructing a new 
query. After Reset. Untitled #N is assigned as the file name to the Query Window 
N again. This feature which prevent the user from “destroying” an existing query file 
by simply clicking the mouse on the Reset button is also based on Interface 


Principle 5: Be able to prevent some severe problem from happening. 


2. Drawing area 

The drawing area is the portion of the Query Window that is bounded by 
the horizontal and vertical scroll bars. This area starts out blank and 1s used to 
graphically construct the DFQL query. As the query becomes larger so that portions 
of drawing area are hidden from the user's view, the scroll bars may be used to bring 
the hidden portions into view. There are two ways to create an object: First, the user 
clicks the mouse anywhere he(she) wants the object to appear in the drawing area. 
An “input box”, the gray rectangle, with a flashing cursor at the center appears on 


where the mouse is clicked waiting for the user to enter any text from the keyboard. 
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After the input box shown up, the user can select either an operator from the pop-up 
menu Primitive or an user-defined operator from the other pop-up menu UsrOpr 
by clicking on the up-side-down triangle. The input box will be replaced with the 
selected operator or user-defined operator. The second way is also clicking in the 
drawing area to create an input box first and then keep typing in text. Should there 
be any typing mistake, the delete key on the keyboard can be used to delete the 
mistyping characters. As the Return key is pressed, the text input ended and the 
DFQL interpreter checks whether or not the entered text is in the name list of the 
primitive operators or user-defined operators. If it is, then the operator whose name 
is entered will appears in the drawing area and centered at where the mouse is 
clicked. If the entered text is not in the name list of the primitive operators or user- 
defined operators, a text object with the text entered will appear and is also centered 
at where the mouse is clicked. There is an example shown in Figure III.3. The 
feature allowing operators to be created in more than one way supports the interface 
Principle 4: Be able to perform the same operation in more than one ways. 

The DFQL interpreter is case sensitive. If the entered text is Select instead 
of select (the name of a primitive operator) and we do not have an user-defined 
operator named Select, then it is created as a text object, not an operator. If no 
characters are entered, after pressing the Return key, the “input box” will 
disappears. 

In order to construct a DFQL query, the query objects must connected with 
the desired data flows. Data flows are the lines connecting output node of any given 
object to the input node of another object (or objects). To draw these lines, the user 


must click the mouse on either an output or input node. Once the mouse button has 
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Figure III.3 Creating an Operator by Typing 


been released, a rubber-band line will be drawn from that node to the current 
position of the mouse. Clicking on the input node or output node of another object 
will connect the dataflow line from the originating node to the newly indicated node 
if the connection makes sense. The following attempted connections do not make 


Sense: 


° From input to input 
° From output to output 
° Between nodes of the same operator 


° Making acycle 


i, 


Should any of these nonsense connections be detected, an error message is 
presented stating that the attempted connection is not allowed. While the rubber- 
band line is “‘on’, clicking the mouse in an blank portion of the drawing area will 
turn off the rubber-band line if the user has decided not to make a connection after 
all. Since an input node may have only one input flow, if the user connects a dataflow 
line to an input node that already had one, the previous dataflow line is deleted 
automatically. 

In order to move an object within the drawing area, the user clicks the 
mouse on the object and drags it to the desired position while holding down the 
mouse button. If the user clicks the object and release the mouse button immediately, 
the object will be selected, i.e., its color will be converted. Selecting a DFQL object 
existing in the drawing area has two effects. First, it allows the selected object to 
deleted. Secondly, selecting a DQFL operator allows the user to retrieve 
intermediate results from the query. When an operator is selected and the Run 
button is clicked in the Query Window, The query will be executed up to and 
including the selected operator. The result of this partial query will then be displayed 
in the Query Result Window. To delete a selected object, the user can select the menu 
item Delete from the menu Edit. The equivalent operation to delete a selected object 
is simply pressing the Command and D keys on the keyboard simultaneously. The 
user 1s also allowed to select several objects and then delete them all at one time. 
However, an object selected can still be moved around in the drawing area. Simply 
clicking the mouse on a selected object will deselects it. 

Double-clicking either on an primitive operator or on an user-defined 


operator will bring up a help window describing that operator. The Help Window is 
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shown in Figure III.4. The left portion of the Help Window is a scrolling list of the 
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Figure IIl.4 Help Window 


names of all operators. The highlighted name is the one we double-clicked on. The 
message shown in the right portion of Help Window 1s the description of the 
highlighted operator. 

Double-clicking on a text object opens up an editor for that object's text 
string. All of the Macintosh 's normal text editing functions such as cutting, copying, 
and pasting text from the Macintosh clipboard are supported in this editor. When the 
OK button is clicked, the previous text for the object 1s replaced with the new string. 

If the mouse is double-clicked on an output node, the columns of the 
relation flowing out of that node are displayed.In this way, the user can determine 
what attributes may be used by operators subsequent to that point in the query graph. 
This assistance is very important in the construction of large queries in which the 


attributes become hard to keep track of. Also, when user-defined operators are used, 


ps 


it is important to be able to easily determine what the names of the attributes are that 


the operator produces. There is an example shown in Figure IIL.5. 
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COLUMN NAMES: 


SID, SNAME, ADDR, PHONE, GPA 





Figure III.5 Columns of a Relation at the Output of select 


3. Pop-up menus 
There are two pop-up menus in the Query Window: Primitives and 


UsrOpr. Primitives contains the names of all primitive operators while UsrOpr 
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contains the names of all the user-defined operators. When a new user-defined 
operator is created, its name will be attached to the end of UsrOpr. 

These two pop-up menus provide another way to create an operator. After 
the user clicks the mouse on the drawing area to create an input box, instead of 
entering text from the keyboard, the user can also click on the reversed triangle of 
either pop-menus depending on what kind of operator he(she) want to create and 
then selects the specific operator from the pop-up menu list. The input box will be 


replaced with the selected operator. 


C. OPERATOR DEFINITION WINDOW 

When the menu item New in menu UserOps is selected, the Operator 
Definition Window as shown in Figure III.6 1s displayed on the computer screen. 
The Operator Definition Window is very similar to Query Window. The difference 
between these two windows are that they have different set of buttons and there is 
an “input bar” in the drawing area of the Operator Definition Window. 

The drawing area plays exactly the same role as that in the Query Window does. 
The input bar is used to define where the input data to the user-defined operator will 
be sent internally. Clicking the mouse on the input bar will create additional input 
nodes for the user-defined operator. If too many input nodes are created by mistake, 
they can be removed by clicking the mouse on the Delete Input button. Each click 
deletes one input nodes from the input bar. Once the desired number of input nodes 
are created, they must be connected to the desired operators in the drawing area. All 
input nodes of the operators inside the user-defined operator must be connected. 
Also, there may be only one unconnected output node in the user-defined operator. 


This single node becomes the output node for the entire user-defined operator. 
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Operator Definition Window 





Figure [1I.7 Operator Definition Window 


When the Store button is clicked, DFQL interpreter first check the internal 
structure of the user-defined operator to ensure that all necessary connections have 
been made and query criteria have also been met. Then the user will be asked a name 
for the new defined operator and a description that will be used as help message for 
the operator. This feature agrees with Interface Principle 1: Be able to provide 


more information when asked. The operator's name is checked for uniqueness 


32 


among all existing operators. If the uniqueness is ensured, the name of the new user- 
defined operator will be added to the end of the scrolling lis of Help Window and 
the UsrOpr pop-up menu list so the user can use it immediately. New DFQL allows 
users to define user-defined operators successively as many as their want. 

The Clear All button clears the drawing area and allows the user to reconstruct 
the user-defined operator. The Cancel button cancels all the operations the user has 


done since the start of the definition of a new operator. 


D. MENU ITEMS 

The items listed in the main menu (Figure III.1) usually remain the same 
throughout the whole session of the application no matter what window ts currently 
displayed. Any items that are not applicable at a given time are made unselectable 
and are displayed at reduced intensity, commonly known as being “‘grayed out’. We 
also provide equivalent key-combinations for some menu items to speed up the 
user's operations. This feature supports Interface Principle 4: Be able to perform 


the same operation in more than one ways. The menu items are discussed below. 


1. Apple 
Apple is a standard Macintosh menu that has no relation to DFQL. It 
provides access to Macintosh utilities called “Desk Accessary” and should be 
accessible at all times (Apple, 1985, p. I-54). The only DFQL specific item in this 
menu is the “About...”. When this item is selected, a brief information about DFQL 


interface is displayed. 
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2. File 

As shown in Figure III.7, the New item executes exactly the some function 
as the New button in the Query Window. It is very possible that the user may close 
the only Query Window unintendedly. Without this New item, the user will not be 
able to open any new Query Windows and need to quit DFQL unwillingly. This New 
item is provided basing on Interface Principle 4: Be able to perform the same 
operation in more than one ways and Interface Principle 3: Be able to recover 
from the unintended or erroneous operation. 


Edit UserOps Option... Info Special Window | 


| Ww 





Figure III.7 File Menu 


The Page Setup... item 1s also a standard Macintosh File menu item which 
allows the user to change printer parameters such as the size of paper, print quality 
and orientation. The Print... item is provided to print out the information of the front 
window of the DFQL. 

The Quit item closes all opened windows and terminates the DFQL 
interpreter execution. Before closing each Query Window, DFQL will check 
whether or not the query in the drawing area of this Query Window has been 


changed since last Save. If there are new changes since last Save, a dialog box pops 


up asking the user if he want to save or not. The user should click either Discard or 
Save in order to proceed. This precaution agrees with Interface Principle 5: Be 


able to prevent severe problem from happening. 


3. Edit 
The Edit menu as shown in Figure III.8 is also a standard Macintosh menu. 
It provides the text editing functions of Cut, Copy, Paste, and Clear. They are 


available whenever the user is editing text items. 
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Figure IIf.8 Edit Nlenu 


The Delete item deletes the selected object(s). The Undo(all) item recovers 
the deleted object(s) and put them back to the drawing area. This feature is based on 
Interface Principle 3: Be able to recover from the unintended or erroneous 


operation. Undo(all) is only active immediately following the deletion of object(s). 


4. UserOps 
The UserOps menu as shown in Figure III.9 is designed for manipulating 


user-defined operators. The New menu item is to open the Operator Definition 
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Window so that the user can define new user-defined operators. The Delete menu 
item allows the user to delete existing user-defined operators from the DFQL 
interpreter. When Delete is selected. the user is presented with a dialog box 
containing a scrolling list of user-defined operators, as shown in Figure III.10. When 
the desired operator is selected, by either double-clicking on its entry or single- 
clicking on its entry and then pressing the Select button next to the scrolling list. 
Once an user-defined operator is deleted, it will disappear from both the scrolling 
list of the Help Window and the UsrOpr pop-up menu list in Query Window and 


Operator Definition Window. The View menu item allows the internal structure of 
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New 








Figure [11.9 UserOps Menu 


an existing user-defined operator to be displayed. When this item is selected, the user 
is provided a selection dialog box as shown in Figure III.11. After the user chose one 
of the existing user-defined operators from the box, an User-Defined Operator 
window shows up and displaying the internal structure of that selected user-defined 
operator. An example of this display is shown in Figure I[II.12. This display 1s 
especially useful if the user-defined operator was provided by someone else. The 


user is not allowed to modify the internal structure of user-defined operator. In this 
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Figure III.10 Selection Box for User-Defined Operator Deletion 
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Figure I1I.11 Selection Box for User-Defined Operator Viewing 
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Figure II].12 User-Defined Operator Window 


way the integrity of the operator is preserved while still allowing some access to the 


internal for the user's purpose. 


5. Options... 
This menu, as shown in Figure IJI.13, is imported from (Clark, 1991). We 
did not introduce any new features to it. All of the items provided in Option... menu 
are toggle items. When the item is active, or “turned on”, a check mark is presented 
next to the item. For example, in Figure III.13 the Sound item is turned “on”, 
whereas the Display Last and Show SQL are “off’. When the Display Last is 


turned on, the output of the last DFQL operator executed will be displayed in the 


38 


Query Results Window when the query is run. This is useful when incrementally 
constructing queries because it causes the display of the results without having to 
use a display operator. Show SQL causes the intermediate SQL code that is 
generated from the DFQL query graph to be displayed in the Query Results Window 
along with the results of the query. This display can be used to troubleshoot any 
execution errors that are not directly apparent from the DFQL query graph. Also, 
this option allows the DFQL interpreter to be used as a translator in which a DFQL 
query is input and a DFQL query is output which could then be run on any SQL 
database system. When selected, the Sound option causes certain easily 


recognizable sounds to be played at different key points during processing of the 


query. 
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Figure III.13 Option... Menu 


6. Info 
The Table item in the Info menu, as shown in Figure III.14 allows the user 


to retrieve information about what attributes exist for tables in any given relation in 
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the database. When Table is selected a selection dialog box (Figure III.15) is 
displayed from which the user can choose which table he is interested in. This action 
will bring up a dialog box displaying the attributes of the selected table as shown in 
Figure IIJ.16. The Help menu item opens the Help Window. We will cover all the 


details about Help Window in a specific section later. 
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Figure III.14 Info Menu 


7. Special 
This menu (Figure IJI.17) is also the original work of (Clark, 1991). The 
only item, ORACLE*Shell stars up a separate application to provide the user direct 
access to the backend DBMS (in this case ORACLE). Since this separate application 


is not Our concern in this presentation, so we do not get into its details. 


8. Window 
There is only one menu item, Cascade Win (Figure [I.18) in Window 
menu. As the user proceeds, there may be several windows opened on the computer 
screen at the same time. Some of them may be overlaid by the others. When 


Cascade Win is selected or its equivalent key combination, Command-W is 
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Figure III.15 Selection Box for Table 
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Figure III.16 Table Information 
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Figure II1.17 Special Menu 


pressed, all the windows will be relocated as the example shown in Figure III.19 so 
the banners of all windows can be seen. This feature allows the user to easily activate 


a completely overlaid window. 
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Figure Iff.18 Window Menu 


E. HELP WINDOW 


There are two ways to open the Help Window as we described before: double- 
clicking on an operator displaying in the drawing area and selecting menu item Help 


from menu Info. Upon opening Help Window, if we want to view the descriptions 
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Figure III.19 Cascaded Windows 





ot any other specific operator in the operator list, we can simply click that operator 
in the scrolling list, the description of that selected operator will be provided on the 
right. This feature agree with Interface Principle 1: Be able to provide more 
information when asked, Interface Principle 2: be able to display multiple 


information at the same time and Interface Principle 4: Be able to perform the 
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Same operation in more than one ways. In fact in order to open the Help Window, 
we do not even need to double click on any operator. We can simply select the menu 
item Help from menu Info whenever we need to consult the help message. Once the 
Help Window is opened, we can view the description of any existing operator. 

It is possible for the user to find that the description of user-defined operators 
in the Help Window need to be modified after the operator is defined. To modify the 
descriptions, the user can double-click the specific operator whose description is to 
be modified to open an editor and enter what description appropriate. Upon 
completion of the modification, clicking the OK button will save the new 
description of that operator. This feature supports Interface Principle 3: Be able to 
recover from the unintended or erroneous operation. Since the primitive 
operators are basic set of operators, DFQL does not allow their descriptions to be 
modified. So double-clicking on the primitive operators cause nothing happened. 
Interface Principle 6: Be able to prevent modifications that are not supposed to 


be made is honored by this feature. 


IV. PROGRAPH AND OBJECT-ORIENTED PROGRAMMING 


A. LANGUAGE -- PROGRAPH 

Since the previous DFQL interpreter was implemented 1n Prograph of version 
2,02, to make things consistent and to import some of the previous code into our new 
implementation, we decide to use Prograph as our programming tool. Another 
reason to use Prograph is that, as stated in (TGSS, Tutorial, 1990, chapt. 1), 


Prograph integrates four key trends emerging in computer science: 


° Visual programming. 
° Object-oriented programming. 
° Supporting dataflow specification of program execution. 


° Providing application building toolkit. 


1. Visual Programming 

Contrary to text-based programming, visual programming uses graphical 
operations to accomplish the programming task. Figure IV. 1 shows the definition of 
methods newPerson, setAttributes and introduce for class Person. In method 
newPerson, the hexagon-shaped operation creates an instance of a specified class 
object (in this case a Person). This newly created Person then flows into the 
operation named setAttributes which is a method defined in class Person, After 
attributes being set by the method setAttributes, the Person with his attributes set 
flows into the operation named introduce, which is also a method defined in class 
Person to have the new person self-introduced. Method setAttributes asks the user 


to enter the person’s name and where the person is from, then assigns those two 
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Figure [V.1 Methods 


personal data from the user as the values of the new person’s attributes, name and 
where from?. The new person introduces himself in method introduce, 

There are four ways of method reference in Prograph: The form of context- 
determined method reference is “//method’’. This reference indicates that the named 
method can be found in the same class as the method containing (calling) this named 
method. In method newPerson, Figure IV. 1, method setAttributes is referenced in 
this form. The form of explicit-class method reference is “classname/method”’. 
Method introduce is referenced in this form. The third form, Universal method 
reference, is “method”. The containing method looks for the method in the 
Universal methods pool. The last form is data-determined method reference, “1 
method”. Prograph looks for the method in the class to which the object arriving at 
the first input terminal of the method belong. This powerful method referencing 
form supports polymorphism of object-oriented programming and late binding. 
Different classes can each have a method of the same name with totally different 
function. When a method is referenced in this form, Prograph does not know from 
which class the specified method can be reference until the class object arrives on 
the input terminal of the specified method at runtime. That is why we say that it 


supports late-binding. 


2. Object-Oriented Programming 
Prograph provides a good foundation for object-oriented programing, 
system classes. Each class has two components: attributes and methods. 
Attributes identify instances of classes. By passing messages (calling methods) to 
objects (instance of class), we can make them act accordingly. In prograph, objects 


of same categories are group into classes, that is to say that a class is an abstract 
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description of a collection to similar objects. In object-onented programming, 
objects communicate by passing messages. The situation is similar in Prograph but 
objects flow into operations to initiate some actions, rather than stationary objects 
sending messages back and forth (TGSS, Tutorial, 1990, chapt. 4). Figure IV. 2 
shows a class window displaying the classes hierarchy, the attributes and methods 
window of class Person. In Figure IV. 1, we have shown one way to assign attribute 
values and to pass message asking the person to introduce himself/herself. The line 
between classes represent inheritances. For example, classes Student and 
Instructor are both descendants of class Person They both inherit all the attributes 
and behaviors (methods) of their ancestor Person. But they can have their own 
additional attributes and methods (Figure IV. 3). In attribute window, Figure IV.3, 
there is a downward arrow in each inherited attribute icon. Method overriding 1s also 
allowed in Prograph. For example class Instructor has its own method introduce 
whose functionalities can be totally different from Person’s.When an instance of 
Instructor is “asked” to introduce himself, instead of referencing the method 
introduce in class Person, the one in class Instructor is to be referenced. But since 
class Student, has no its own method introduce, so when an instance of class 
Student is “asked” to introduce herself, the inherited method introduce defined in 
its parent class Person is to be referenced. Programmers can also make their created 


classes descendants of system classes so a great deal of effort can be saved. 


3. Dataflow Programming 
In Prograph, each operation can have zero or more input terminals and zero 
Or more output roots representing by small circles attaching to the top or bottom of 


operations (Figure IV.4). Data flow along arcs connecting terminals and roots. When 
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Figure IV.2 Class Hierarchy and Class Components 
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Figure 1V.3 Classes Instructor and Student 
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all required input data become available at an operation’s terminals, the operation 
can not execute or fire. Specific order of execution is not prescribed in Prograph 
programs. This situation implies that concurrent execution of several operations is 
likely to occur. To enforce the order of execution, synchros are provided as shown 
in Figure IV.4. In Figure I'V.4, there is a direct arc connecting the root of operation! 
and one terminal of operation2, so operation 2 must execute after the execution of 
operation 1. Same situation between operation 1 and operation 3. But, since there 
are no direct arc between operation 2 and operation 3, so they can execute 
whenever their required input data are available. Execution order of operation 1 and 
operation 2 is not prescribed without the synchro. With the synchro emerging in 
Figure IV.4, the execution of operation 3 is enforced to wait until the execution of 
operation 2 is done. In method setAttributes, Figure IV.1, we used a synchro to 
ensure that a person’s name was asked before where he/she is from Is. 

By combining the dataflow specification of program execution and some 
powerful debug facilities, Prograph allows programmers to debug programs by 
inspecting the data flowing in the programs from debug mode. With the inspection 
of the dataflow, programers can see how programs work and why it does not work 


the way as expected if there are some errors in the programs. 


4. Application Building Toolkit 
The application building toolkit in Prograph supports independent 
specification and management of the interface through high-level tools and 
facilities. For example, the application, menu, window, and several window item 
editors are some powerful and easy to use tools provided in Prograph. application 


editor (Figure IV.5) serves as a library of menus and windows. The menu editor 
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Figure [V.4 Terminals, Roots, Arcs and Synchro 


(Figure IV.6), window editor (Figure [V.7), and window item editors (Figure IV.8) 
are used to specify the “look and feel” of the menus and windows created and 
organized using the application editor. So instead of developing the windows, 
menus, and their items we need in the DFQL user-interface from scratch, we can just 
specify some essential informations in each relevant editor and the application 
builder will creates what we need according to the informations we specified. To 
refine any portion of them, we just return to the relevant editor and respecify some 
relevant informations. No recoding and recompilation needed. 

Since there are some new features and facilities added to the 2,02 version, 


SO Our program is implemented in Prograph of version 2.5 (e.g., the pop-up menu 
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Figure IV.5 application Editor 


we used in the Query Window is a new added facility to version 2.5). We do not 
intend to get into the details of Prograph. The following references by The Gunakara 


Sun Systems Limited (TGSS) are recommended for those who are interested in. 


° Prograph: Tutorial, second printing, 1990. 
° Prograph: Reference, second printing, 1990. 
° Prograph: 2.5 Updates, first printing, 1991. 
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B. WHY OBJECT-ORIENTED PROGRAMMING 

Object-oriented programming is often referred to as a new programming 
paradigm (Budd, 1991). In Clark’s DFQL interpreter, object-oriented approach was 
attempted. But after a careful examination of Clark’s program, we found that some 
major object-oriented programming features, such as responsibility driven, 
information hiding, and modularity do not play their role. And the program is also 
tightly interconnected by heavily using the explicit-class method reference.These 
drawbacks restrict the reusability of his program, so in order to use some methods 
in his program we spent some significant effort to modify and re-modularize his 
original code. Because of this experience we decide to approach our new 
development from object-oriented view so that our code may be more reusable, 
portable, and maintainable. 

During the examination and modification of Clark’s program, we also found 
many attractive features of OOP can be adopted to model our new DFQL interface. 
In our view, DFQL interface consists of objects like Query Window, drawing area 
(a canvas in which we draw our query) and operators, etc. These objects are 
manipulated in response to events, such as the clicking or dragging on the body of a 
DFQL object cause the object being selected or dragged. This awareness also 


encouraged us to do experiment of object-oriented programming. 


C. Evaluation Of Object-Oriented Programming 
In this section, we are going to discuss some features of object-oriented 
programming we applied to our new development of DFQL interface and some 


benefits we have gotten through the whole design process. 
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1. Benefits of Responsibilities-Driven, Class, and Inheritance 

To organize or discover classes, we need to take the responsibilities of each 
potential class into consideration. Clear assignments of responsibilities increase the 
degree of independence of classes thus increase the degree of information hiding 
and reusability. When we make an object responsible for a specific action, we can 
expect a certain behavior the object is to behave as we passing the request to it. The 
higher the degree of behaviors of objects we can expect, the easier we can debug our 
program when errors occur and the easier to expend our program by assigning more 
appropriate responsibilities to appropriate classes without causing intensive 
modification to the program has been existing or importing unexpected interferences 
between new code and old code. 

Figure IV.9 shows the classes hierarchy of our program. The white-colored 
classes are system-provided while the black-colored classes are our created ones. 
Each class representing one category of objects encapsulates informations and 
functionalities within its attributes and methods. This classes hierarchy is organized 
after the following analysis: Class Query Window represents the main window 
(also named Query Window) with the responsibilities of detecting and handling the 
mouse click events on its item such as button close box, etc., creating new Query 
Windows, setting attributes of new created Query Windows, loading query files onto 
Query Windows saving query files to disks and closing Query Windows, etc., Class 
Query Object represents all query objects. Classes Text Object and Operator 
represent text objects and operators respectively. Because they are both query 
objects so we make them the descendants of class Query Object to inherit the 


attributes and methods we defined in class Query Object. Since operators can also 
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Figure IV.9 Classes Hierarchy 


be grouped into primitive operators and user-defined operators, so we make classes 
Primitive and UserOpr the descendants of class Operator representing primitive 
operators and user-defined operators respectively. Class Query Object and its 
descendant classes are responsible for maintaining and creating query objects. Class 
DFQLCanvas represents the drawing area (the drawing area just like a canvas) 


within which we “draw” our query. It is responsible for detecting and handling all 
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kind of mouse click events in the drawing area and acts accordingly, drawing 
objects, dragging objects, and deleting objects. Class InputBox represents the 
“input box” within which users type in the text for the later creation of query objects. 
It is responsible for displaying the “inputbox” at where users click the mouse and 
reading text that users type in from the keyboard. Classes QueryResults, 
UsrOprWin, Printer and its descendant DFQLPrinter, Line, and Help are created 
by following the similar analysis. 

Assuming the user wants to create an operator by selecting one from either 
pop-up menus Primitive or UsrOpr, then when the event of clicking mouse in a 
pop-up menu and selecting one operator from the menu is detected by Query 
Window, Query Window passes message requesting the creation of an operator 
with the name specified to class DFQLCanvas. Upon receiving the request, 
DFQLCanvas does some prelimilary actions and then passes the same request 
received from Query Window to class Primitive, Primitive then check its 
primitive operator list whether there is one with the same name passed in or not. If 
there is one, Primitive returns the matched operator back to DFQLCanvas. If there 
is none matched, the same message is delivered to class UserOpr to create an user- 
defined operator. After the operator is returned, DFQLCanvas draws it in the 
drawing area. The ellipses in Figure I1V.10 highlight the process of message passing. 

We make each class an encapsulation of abstractions having two faces. 
From the outside, a user of that abstract encapsulation sees only a collection of 
methods which define the behavior of the encapsulation of abstractions. On the 
internal side, attributes (some people use the term data variables, but for 


consistency, we will use attributes through this thesis) are defined to maintain the 
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internal state of the object. In the above example, by using responsibility-driven, we 
do not allow classes to interfere or modify attribute values of other classes because 
we view changing attribute values as the internal affair and all of them must be 
maintained internally by the class instance itself under any circumstances. This 
measure makes a program less error-prone and ease the maintenance of a program. 
Also, the information hiding rule is observed by the careful responsibility 
assignments. For example, DFQLCanvas issues requests of query object creation 
to classes Primitive without knowing how they are created. 

The clear division of classes helps us design a well structured and 
modularized program. The hierarchical organization also helps us to remember the 
whole structure of our program and the relationship between classes easier and 
better. Since many methods are inherited by the descendant classes from their 
ancestor classes, we do not need to replicate codes over and over again. This feature 
shortens the development time and supports information hiding also. Figure IV.10 
shows an example of inheritance. In Figure IV.10, when either class Primitive or 
class UserOpr receives the message requesting the creation of an object from class 
DFQLCanvas, since there is no method capable of creating objects defined in both 
classes Primitive and UserOpr, the method create defined in their parent class 
Operator will be referenced as if itis defined in their own classes. This benefits is 
more significant in the inheritances of our created classes from system provided 
classes. For example, by making classes Query Window, QueryResults, and 
UsrOprWin as descendants of system provided class Window, we can simply use 
the methods such as Close, Activate, and Idle defined in class Window without 


knowing how they are implemented. 
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Figure IV.10 Process of Message Passing 
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2. Benefits Polymorphism and Late Binding 
Polymorphism is an feature to send the same message to instances of 
different classes. It enhances the readability of software and leads to an easier 
extension of code. Figure IV.1l1shows an example of Polymorphism. When we 
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Figure [V.11 Example of Polymorphism 
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choose menu item Quit from menu File, method Quit defined in class Menu is 
called. When this method executes, a list of windows opened flows from the nght 
Output terminal of operation windows to method Close which is of the Data- 
determined method reference form. As we mentioned in last section, all windows are 
viewed as instances of different classes, so when the message Close is sent to them, 
they will behave according to the Close method defined in their class or ancestor 
class. Because all windows are subclasses of system class Window, so except 
Query Window which need to save the query file before closed if the content of the 
query file has been changed), all window will close by calling method Close defined 
in class Window. The method Close defined in class Query Window as shown in 
Figure [V.11 overrides the method Close in the parent class Window by having the 
same name and different behavior. It first save the query file which has been changed 
if the user desired and then calls the method Close defined in class Window (the 
upward arrow means method Close in the supper or parent class 1s to be called). In 
this example, we see the same message Close sending to instances of different 
classes causes them to behave differently. We also see that /ate binding utilized in 
this example. The proper methods Close to be referenced is unknown until the 
instances arrive (i.e., until run-tome). This makes the high-level software design 
more flexible. 

The overriding we saw in last example is just in form of polymorphism. 
Another form is overloading which makes the flow of software execution easier to 
be followed by users. Figure [V.10 shows how the methods create defined in classes 


Query Window, DFQLULCanvas, and Operator are referenced. We overload the 
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method name create so the way an operator is created easier to be understood and 


the code is also easier to be read. 


V. CONCLUSION 


A. LESSON LEARNED 


some lessons we learned in our development of this new DFQL interface can be 


Stress in two aspects: user interface and object-oriented programming. 


1. User Interface Aspect 


As an application designer, we need to originate all the ideas from the users’ 


point of view. So human factors need to be taken into consideration. Our experience 


is that some established principles like those we listed in Chapter I need to be 


followed all the time. We also evaluate some human factors such as 


How long does tt take a regular user to learn this new application. 
We need to provide users a consistent, well-explained, and easy-to- 
use, and easy-to learn tool so they will not get confused or frustrated 
by the complexities of the tool. 


What kind of errors may be made by users. Taking this factor into 
consideration leads to a design of careless-proof or even fool-proof 
application. 


What degree do users maintain their knowledge about the 
application after a period of time. To increase the degree, the 
consistency must be enforced and on-line help messages must 
always be available. 


2. Object-Oriented Programming Aspect 


The following is a list of lessons we learned from the object-oriented 


programming aspect: 


Each class ts responsible for one task or some intuitively sumnilar 
rasks and allow attribute values to be modified or maintained only in 
its own class. This reduces the degree of interconnection between 
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classes and makes each class cohesive and modular so later 
modification and extension is easier. 


¢ Avoid writing long methods. Try dividing a task into several subtasks 
which can be implemented as clearly defined methods. This also 
makes later modification and extension easier and increases the 
reusability. 


° Properly use polymorphism to make program easy-to-read, This 
makes programs more symmetric and easier to be understood. 


¢ Avoid using explicit-class method reference. Explicit-class method 
reference makes methods tightly interconnected so when a class 
name is changed, we have to change all references in the whole 
program. This is error prone and time consuming. 


¢ Properly use abstract superclass to support information hiding and 
inheritance. We discussed many benefits of information hiding and 
inheritance. Proper use of superclass allows the programer to 
concentrates on the further development without paying attention to 
the low-level details of the referenced methods. 


B. SUMMARY 

This thesis provides an improved user interface of DFQL originally introduced 
by Gard J. Clark and C. Thomas Wu in 1990. In this thesis, we eliminated the 
shortcomings of user interface pointed out in their paper and added some new 
features to it. Now, this new DFQL user interface allows users to create DFQL 
objects simply by clicking the mouse and then entering the text right on the 
computer screen. Some tedious operations in the previous version of DFQL such as 
deleting an object, selecting an user-defined operator have been simplified in our 
new unplementation. We also make on-line help messages easy to get and allow 
information displaying window such as Help window, Query Results window and 
User-Defined Operator window to co-exist at the same time when users are 


constructing their queries in Query Window. This makes more reference 


information available at the same time. We also allow users to open Query 
Windows as many as they want and define user-defined operators consecutively. 
The content of help messages of user-defined operators entered by users can also be 
modified easily. 

In addition to the new features we added to the DFQL user interface, we also 
did an object-oriented programming experiment on this new implementation. The 
main techniques of object-oriented programming such as message passing, class, 
responsibility-driven, inheritance, and polymorphism are used. The benefits of these 


techniques are also evaluated. 
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APPENDIX 


Only the source codes we developed are presented in this thesis. The orginal 


codes of system provided classes are not printed. 
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Z2mMenu/Quit 1:1 





“AAA ddA ddd dd dd dd dd bbb 1S TA5aS SG 4. 


g23Menu/cascade win 1:1 





Cascade all windows. 


CLLZZZL ZILLA Lik ka Lal 


Z2Menu/cascade win l:trelocate 1:1 





Query Window Wed, May 20, 1992 6:09 PM 





Z2aMenu/delete 1:1 





OAL Leth titshatsidhsatbhddatd hdbar 


Query Window Wed, May 20, 1992 6:09 PM 


Z2Menu item/dim 1:1 











Takes as input a LIST 
of menuitems to dim 
and the associated menu. 


CM hh hha ddddhadakihahihahahar 


ZZmMenu ttem/highlight 1:1 


Takes as input a LIST 
of menuitems to highight 
and the associaled menu. 
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Query Window Wed, May 20, 1992 6:30 PM 





ZaQueryResults/showQueryResults 1:2 
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<<QueryResults>> 


set query tend) 
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ZZQueryResults/showQueryResults 1:2previous win loc 1:2 
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Application 





Z3QueryResults/showQueryResults t:2previous win loc 2:2 
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{50 15} 


Query Window Tue, May 19, 1992 11:01 PM 


ZZQueryfesults/showQueryfesults 1:2set query text 1:1 
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Query Window Tue, May 19, 1992 11:01 PM 





Z3ZQueryWindow/clear 1:1 
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ZjZQueryWindow/clear 1:\locate inBarRect 1:1 





Vhiddadidalatiditstitihsthhshatdtata 





Z3A2QueryWindow/Close 1:1 


ae Ri am 


«QueryWindow» 









‘save if file changed: | 


Uhhh bhabih§i5hatihdhatstshatihbhssg 


Query Window Wed, May 20, 1992 5:23 PM 


Z2QueryWindow/Close I:tsave if file changed 1:1 


LLL LLL LLL LL adhe hah 


Stile changed? cececcecee § 1 (¥] 
TRUE |X| 
: Discard 
Euaang mossagey) Discard 


Digcare 


g 
zisave asy 


If the window to be closed is of type “QueryWindow" 

and tne contents of the canvas in that window has been 
changed(i.e.,file changed) prompt the user to save it before 
closing the window. 


CALL hha itadatstslahshihatisspa 


| Operator Definition Window 


C2QueryWindow/Close t:tsave if file changed 1:lwarning message 1:1 





. has been changed. Save it? 
. The content in 





ZzQueryWindow/newQryWin 1:1 
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Query Window Wed, May 20, 1992 5:23 PM 


ZZQueryWindow/create 1:1 
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<<pop-up menu>> 


<<Query Window>> 


This method is to handle the pop up menu 
selection. An object will be created 
according to the pop up menu Item selected. 
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ZZQueryWindow/activateQw 1:1 
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<<QueryWindow>> 


Zupdate menu | 


It's possible to activate a Query Window with 
other types of window being trontmost. So it's 
necessary to update menu. 
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ZZQqueryWindow/activateQWw I:lupdate menu 1:1 
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Query Window Wed, May 20, 1992 5:23 PM 


Z3ZQueryWindow/activateQW 1:idraw 1:1 
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ZzQueryWindow/activateQW 1:lupdate menu I:lenable menu 1:1 
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Z2ZQueryWindow/activateQW 1:lupdate menu 1:lupdate Edit 1:1 
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Query Window Wed, May 20, 1992 5:24 PM 





Z32QueryWindow/activateQW 1:lupdate menu 1:lupdate File 1:1 
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Z3ZQueryWindow/activateQW 1l:lupdate menu I:lupdate Edit 1:lactivat delete 1:1 
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Z2QueryWindow/activateQW 1:lupdate menu 1:lupdate Edit 1:1deactivate others 1:1 
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Query Window Wed, May 20, 1992 5:24 PM 


Za2QueryWindow/activateQW I:!draw 1:!draw input box if it exists 1:1 
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ZAQueryWindow/activateQW t:tdraw t:1draw input box if it exists 1:1drawGenericOp 1:1 
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Z2QueryWindow/activateQW t:tdraw t:!draw input box if it exists 1:1drawGenericOp I:!getGenericRect 1:1 





ZaZQueryWindow/activateQW I:!draw 1:!1draw input box if it exists 1:!1drawGenericOp t:1do draw 1:1 
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Query Window Wed, May 20, 1992 5:24 PM 





Z2QueryWindow/set-attributes 1:1 
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ZZQueryWindow/set-attributes l:!get window location 1:2 
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Z2QueryWindow/set-attributes 1:!get window location 2:2 
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Query Window Wed, May 20, 1992 5.24 PM 









ZjZQueryWindow/set-attributes I:lquery win # +1 1:1 
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Application 






CLL hha hhh hha tasidstdhdpadatibate 


CZQueryWindow/set-attributes t:!Inew DFQLCanvas 1:1 





DFQLCanvasLis& 


Create a new DFOLCanvas for each new QueryWindow. 
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Z3QueryWindow/set-attributes 1:l1query win # + 1 I:linteger to string 1:3 
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Z2QueryWindow/set-attributes 1:i query win # +1 1:linteger to string 2:3 
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§1. You can't open so many windows. 


Query Window Wed, May 20, 1992 5:24 PM 


Z2QueryWindow/Key 1:2 









<Window> Event Record 


Xeelected iten4 






ye lreadke board 


User should press “return® to finish typing. 
So keep reading inputs from keyboard until 
“return” is pressed. 


CM Mhdh hha th5hddstdddhs thhddatishhadsr 


ZzZQueryWindow/Key 2:2 
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<Window> » Event 
selected ite Z Record 


DFQLCanvas 


sicreatey 


When “return” is pressed, create an gdbob} 
according to the text the user typed in. 
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ZZQueryWindow/Key 1:2return pressed? 1:2 


Go 


EventRecord 





charCodeMask_ 


TRUE 13(x] 





Z2ZQueryWindow/Key 1:2return pressed? 2:2 
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EventRecord 





- FALSE 


Query Window Wed, May 20, 1992 5:24 PM 





ZZQueryWindow/reset 1:1 
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Gac-end- drawing 


Clear drawing canvas in Query Window, empty gdbobjylist. 
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Z2QueryWindow/reset I:!reset canvas 1:1 





<<DFQLCanvas>> () 
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Z2QueryWindow/reset I:treset file 1:1 
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Z32QueryWindow/reset I:lreset canvas I:lreset newOpCenter 1:1 
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Locate the newOpCenter at the top of canvas. 
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Z2QueryWindow/saveit 1:2 





filename vol# 
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<<QueryWindow>> 






mkbdackup 











Stile changed¥ 


First backup the file if possible, and then save 
the data from areciist into filename on voi#. 


Query Window Wed, May 20, 1992 5:24 PM 


Z3QueryWindow/saveit 2:2 


LLL LLB 


filename vol# 


lf the backup operation failed, then don't 
save the new file dDecause it could write 
over our previous data without having that 


data backed up. 


The error messages for failed backup are 
all contained in the mkbackup local method. 
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Z2QueryWindow/saveit !:2mkbackup 1:2 
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the file did not previously 
‘ . exist, don't make a backup and 
lerminate with 
43 i iin success 
Load tne oid data trom 
the original filename it 
this doesn't work goto next 







cokes 


lf for any reason (other than above) the 
backup couidn't be made terminate this 
local method with failure. 
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Query Window Wed, May 20, 1992 5:24 PM 











Z32QueryWindow/saveit 1:2mkbackup 2:2 





We couldn't laod tne data from the old 
data file. Generate the error message 
and then terminate with failure. 
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Z23QueryWindow/saveit 1:2dosave 1:2 
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Save the data 
into the input filename. 
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ZAQueryWindow/saveit 1:2dosave 2:2 












if there was an error on saving 
the data generate the appropriate 
arror message. 
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§1. Your data will not be saved! 
§2. “Error in attempting to write to ° 





ZaQueryWindow/saveit 1:2mkbackup 1:2cklength 1:2 





The new filename with °.bak" concatenated to 
it is of a valid length (<=31) so continue. 


CLEL LLM hah hihdhatithitutibssse 





ZQQueryWindow/saveit 1:2mkbackup 1:2cklength 2:2 








Filename with ° bak’ 
concatenated to it was too 
long so generate error 
message and fail this 
operation. 
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Z3QueryWindow/saveit 1:2mkbackup 1:2cklength 2:2 





) Your file wilf not be saved!" 
1s too long!” 
Sorry, Backup file name: 


ZZQueryWindow/saveit 1:2mkbackup 1:2cksave 1:2 


———— 
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Saving tne backup file was successful. 


CML Lith Lihshatihstatbdghes tatghabd 





: ZZQueryWindow/saveit 1:2mkbackup 1:2cksave 2:2 


CLA 


} (13) There was an error on trying to save 
the backup file so generate an error 
message and fail tnis local method. 








Your data wilf not be saved! 
Backup file could not be made. 





ZZQueryWindow/loadit 1:2 





filename volume 
LiL LL hihhihtiihtlitihtlitatiehl 


<<QueryWindow> > 






EZ processioad 4 


If the file has not been opened 
load the data from the 

specified file. Processload 
updates the gdbobjlist and window 
or reports on any errors that 
were generated by the load. 


CLL Mh hn dh hihabihdhats tite hahiha dr 


Query Window Wed, May 20, 1992 5 24 PM 





ZZQueryWindow/loadit 2:2 





hhh hap hhdadhibhs d,hddatidideghstihd 


filename volume 


The iflis : §1 
Go 


(13) [Bgetwinaow 4] 


OM Ahh dhahddspadspp bas bldsbatbhdee 


§1. ° has been opened in 





ZAQueryWindow/loadit 1:20pened? 1:1 





UML Lb hahatitstitstitibsfsttlhatade 





Z3QueryWindow/loadit 1:2processtoad 1:3 









If no error was generated then 
load the returned data into the 
arechst and then update the 
window with the new dala 


Lica iio canvas J 


Lh hha hhh dha tbihdhs tibet hbhahadp 


Query Window Wed, May 20, 1992 5:24 PM 


CJQueryWindow/loadit 1:2processload 2:3 










Couldn't open tiie 
error. 







hd 
ww 
ww 
ww 


» 4 > 


yeCautionAlerY 






UL ha hatatstiddbatitihbatibhdattssbd 


*Sorry, | could not open the lile: ° 


Z2QueryWindow/loadit 1:2processload 3:3 






pw File was of the wrong type 


J\N error. 





CMM shititthitskststibststitshsahahe 


* is ol the wrong type!” 





CZ2QueryWindow/loadit 2:2getwindow 1:1 


Sse ; 
‘find-instanc 6, 
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ZAZQueryWindow/loadit 1:2processload 1:3laad into canvas 1:1 





<<QueryWindow>> ystilename gata 


\ 


DFQOLCanvas 





CLL ahhh bddihaddditdhitdhatdihkd bahar 





Z2QueryWindow/loadit 1:2processload 1:3load into canvas 1:1do load 1:1 





Mid hdd ddd ddd dddddd ed sedsedssdd 4. 


Z2QueryWindow/save as 1:1 





Save the data into 
the file entered by the user through 
the put-file dialog. 


CLM he hhh hdddbatihdhstititutshhddr 


Query Window Wed, May 20, 1992 5:24 PM 


1. "has been opened in 


Z3ZQueryWindow/save as 1:lused in other wimdows? 1:3 





User did not change the 
original file name. 


ZZQueryWindow/save as 1:lused in other wimdows? 2:3 


Le LiL Le Le ahhh bib5hg,tusitsld 









filename 


e e 
[apsres nome wncons 7 


FALSE 








ZZ2QueryWindow/save as 1:lused in other wimdows? 3:3 





QMQkLhe hhh ahha tbibdhatigeststihte 


filename 
S! | find window 4] 
The file ° ” 

‘ window name 

(13) 
f 
y, 2 
UY join Z 
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Z2QueryWindow/save as t:tused in other wimdows? 2:30pened in other windows? 1:1 





LLkhethhhh Lhthbhatihsitstiddihetdhpdahd 





NULL 


Vhs pbhsddhdhatsttbshddphstahdhakd 





Z32QueryWindow/save as I:lused in other wimdows? 3:3find window 1:1 





Lhe hha bathhatstibst§st}idi thd 








Applicalilon 






tind-Inelanc 4 


WLLL LLL 





ZZQueryWindow/open 1:1 





3 After verifying the user's intentions 


<<QueryWindow>> (if there have been any changes to 


the original query) on what to 

do with the current query, puts up the 
get-file dialog to allow tne user to 
pick or enter a ‘ile to load, then 

if it was a valid file load gdbobjiist 
from it. 


(‘OBIN') 








Lik hahdhshhdityphihd hati bstatphab 
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Z2QueryWindow/readtext 1:1 





Reads ONE iine from a file. 
Trims trailing blanks and 
adds a Carriage return. 
Oulpuls a string. 





Z2ZQueryWindow/openloop 1:1 


CLL Lalas gil SAAD ISLSASP. 










To be calied repetitively 

lo open a file. Wili loop 
untl the file is opened. 
DANGEROUS to use if the 
file requested may not 
become availiable. This will 
then toop forever. 


Query Window Wed, May 20, 1992 5.25 PM 





ZZQueryWindow/save 1:1 





hhh Ahh adhd hha ibid hi pp hits thshs hah 


Query Window Wed, May 20, 1992 5.25 PM 


ZAinputBox/readkeyboard 1:1 





Read keyboard and enlarge the input 
box according to the length of the text. 


Vb shithhihdbhdhatiddhshhhd hats lsh 


ZZ\nputBox/readkeyboard 1I:lresize input box 1:1 





4set néw $i2e- 


(Lik Lh hahihibets5hdbatsdihstatsthsddr 


ZZ\inputBox/readkeyboard I:tresize input box I:iget string width 1:1 





ZZinputBox/readkeyboard t:lresize input box I:tset new location 1:1 


QML EL Lhe hhh hatatibifidlhatsi 





Lh ha thhihsthhhhatdddhadsbbdhat shh 


Query Window Tue, May 19, 1992 8:12 PM 





@ZZ4inputBox/readkeyboard 1:lresize input box 1:lset new size 1:1 


HAMhikhhahs phbbhatiddhstidtfshsbshat 





LIGHTS IAAATMAAA MA MMSS ASA AMA ASSSS 0. 





Z2inputBox/init inputbox 1:1 





ii ths Latidgbstatdhsatstihstihdhi 







Make the input box unselected 
and invisible. 


Chk hipdhakshdhathstatstdsdbbhatshdlde 


Query Window Tue, May 19, 1992 8:12 PM 





Z2Z0FQLCanvas/updategdbtext 1:1 





<<DFQOLCanvas>> 









ma 


Ferase od 0b) 
(Egat newiext & cenier| 









| CMIMLMMMIMM IM IMM MM MAM MML¢ 1. 





ZZ0FQLCanvas/updategdbtext I:lerase old obj 1:1 





{/ 
f[doerasey 


CLL Ak Lh Mh hadts)hatitihstsdsdsa take 


Z20FQLCanvas/updategdbtext I:tget newtext & center 1:1 





. You may edit the string below. 


Query Window Wed, May 20, 1992 6.34 FM 





Z20FOLCanvas/updategdbtext 1:1new gdntext 1:1 
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ZA0FQLCanvas/create 1:2 


) 3 : text 


<<DFOLCanvas>> 


Ferase nowt box] 


oy 






PD) 
2) 
25 


| sel file changed? I Ca CCCcececeedgececee ee 










12 Init INpUtdOX | 
2235 


'e cs 
ZlidrawobjA 


ULM ihe hitihabshstatibshatib§sher 


[Fass-to-gabonjre'] 





ZZADFQLCanuas/create 2:2 





Just hide the input box 
if the input Dox is empty. 


Idbdddddddddddddddddddddat td hd tds) s. 


I 


CZ20FQLCanuas/create 1:2erase input box 1:1 





COLL LLL La haha atatitstshhe 
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ZZ0FQLCanvas/create 1:2set file changed? 1:1 








Ctiie changed Y; 


CALM Ahh dha tidbdtadih5dhahadthathhdheee 





ZAZ0FQLCanvas/create I:2getobject 1:3 


LLL 


tex! — point instnum 









instnum 





ZA0FQLCanvas/create I:2getobject 2:3 





text point dispLegtrinstnum 






WygicreareYAx| 





CZZ0FQLCanvas/create I:2getobject 3:3 





text. point dispLegth instnum 


WiMeete a10eGYYyY7 
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ZA0FQLCanvas/create 1:2add-to-gdbob jlist 1:1 





CLL LaLM ha Liha halatitattddhstatste 


a 


Z320FQLCanvas/create 1:2erase input box I:lgetGenericRect 1:1 





(Fiocarawinputoary 


Draws all objects in th canvas. 


(LL ehhh tihidatstitstatihtihita te 
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Z20FQLCanvas/dodrawall 1:tlocdrawinputbar 1:2 





CL Mh hititihstidbdbabb hits tdhhdd 





ZZ0FQLCanvas/dodrawall 1:tlocdrawinputbar 2:2 









y idrawinputbaY 


CMM akhhihstib5hdstsidhs bah shatshhdd 





Z0FQLCanvas/getcanvas 1:1 





LLL La tatbhsiattbehatituthh 


Application 








OFOLCanvas 


Returns the canvas from 
Query Window. 


Z20FQLCanvas/rubberb 1:1 





LLL he atest habatihitptsdddbatd 






V8e-begin-drawin@ 
t™ 


_. patXor_ 


L/ 
nMod 
f) 











~ 

i 

ww 
Giidtawling 

BA I29 





"4 e = y 
Zec-end-drawing Rubberband method. Does the rubberband 


of line drawing when the user is trying 
to connect objects with lines. Uses continuous 
draw and erase routines. Until a mouse Click. 
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. ZQ0FALCanvas/rubberb 1:1waittilldone 1:1 


* 


Focinewmouse 





Erases a line from point! to point2 
by changing tne pen mode. Changes 
pen back to patCopy when done. 


CALL Liha hdd hahaddbststthatstiher 





ZA0FQLCanvas/drawline 1:1 













SS 


Yep oint-to-int Z 


Draws a line from start point 
to end point. 


CL Lik he hihahstdtahsatisthetshsbhathae 
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+ "al, 





Z20FQLCanvas/bedrawline 1:1 





Same as drawline but includes 
the begin and end drawing 
primitives. 


CAikhihatitthatbddhststidiahshhhadshde 








ZZ20FQLCanvas/drawrtconnects 1:1 





<<DFOLCanvas>> gdbobllist object 














pea} 


_—_ 
Z : ccéy; Grawrtiine 
Zec-end-drawings* ! I 


933955 — eos} 











Draws all connecting lines from the 
root of an input object. 


OLA Lh bahshstidihDstitdhatitshe 





Z20FQLCanvas/drawrtconnects I:!drawrtline 1:1 





LNAGAE A Added dd dddd ddd bd dd ddd dds, 


gdbobdjlist (instnum terminal#) 





¥ . ydetach-Z 
[ get terminalist 5 2 


Ld] Z, 77 
“center point center point 


Zildrawlind 
G 


Ck Liha titpbatdtddatsidpsutdhahddear 


Query Window Wed, May 20, 1992 6:35 PM 


I ZZ0FQLCanvas/drawrtconnects 1:ldrawrtline I:lget terminallist 1:1 





; gdbobjlist 
| instnum 





Oraws the input bar for the user-defined 
operators screens. 


(hha tbh ihatihdghattsppatitihahs 


ZZA20FQLCanvas/drawinputbar 1:1draw it 1:1 





Frame RoundRect4ceg FillRoundRecY 


(LLL LLL LLL hhh thahatlathfee 


a4 
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er 





Z20F QLCanvas/drawinnodes 1:1 











Fopeaterecish 
LY, 
baad 
Ys lidodrawal Lo 


Oraws nodes on the input bar. 
Used from user-defined operators. 


OAL b)ibbathbitafihhhsatdhdhstddddahee 


GA70FQLCanuas/drawinnodes J:lupdaterects 1:1 


top spacing 









: > aE 
Vec-begin-drawing 
cB) 


Erases the input bar from the canvas. Used at 
the termination of user defined ops screens. 


Mik ha kbhahadatdhatiddbatithhi tah 


Query Window Wed, May 20, 1992 6:35 PM 











Z2Z20FQLCanvas/doerase 1:1 


LLL LLL 


__ patBic_:OFQLCanvas>> object 


J 

hw 

v * 
“ srcBic 


Ww 









Zz TextMode b 2009 » 4 


y ° 
erasestulf | 
w 


a Ge 





Y 
& 
Kus Erases the object based on the 
we 
I 
w 


patCopy_ object number (the POSITION of 
= : the object in the list) NOT based 
on the instance number. 


ercOr_ 0 


= ww 
oe ~ 
yTextMode4 


MMMM MAILS AA AM MAA “IDM Ma AAAS Ss. 


ZZ20FQLCanuvas/doerase I:terasestuff 1:1 








Shi dddddtlddd dds bd dd dddddddddddds. 


CZZ0FQLCanvas/doerase It:terasestuff t:linvert if selected 1:1 


LILLE Lhe hhh he thd hati ths tiphh 






VM invertRoundRec} 


Lhe h5hhatbdddhatiddhatst§sbstshise 
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ZZ0FQLCanvas/drawtconnects 1:1 








eee) es 


29999247 grawiline 1) 


Draws all conecting lines from 
each terminal of an input object. 


Vi ha db bdhidphdhihihthathdshshdatbar 





ZZ0FQLCanvas/drawtconnects 1:1ldrawtline 1:2 












incoming objlist instnum 





O means no 
line 





\N 





Ylicenterrec Y 
center point 


OL hadhithhatihihahihdhstitshatstdr 





Z20FQLCanvas/drawtconnects 1I:!drawtline 2:2 


CALE 


This means there was no line 
to erase. 





CLE LALA Nh hh hath hha ihshgdthd5had er 





Z20FQLCanvas/drawobj 1:2 





F draw gdbtext 4| 
* f 4 
A, 4, 
sc-end-drawin ag 


Kc t}hhhatitidsdtisdsdtpdhhstdtsthahede 


Query Window Wed, May 20, 1992 6:35 PM 


ZADFAaLCanvas/drawobj 2:2 


Lh hhh shhh bddbhatdibidadddshs 


\ operator input 
‘draw Primativa & UserOpr t 
« 


2$c-begin-drawings? 
Draws gdbopr object from each 
of the component parts. 


CA Le thd bbibhstshabsthdabahadshaded 










SN 





ZQ0FQLCanvas/drawobj 1:2draw gdbtext 1:1 


LiL Le hhh thee dibibetstibatak 


/ 






y rect-to-int J, 


so 










Fe.130) Fe50) Yaiepsiciny) ZilinverY 
~ 


CZ0FQLCanvas/drawobj 2:2draw Primative & UserOpr 1:1 


CLL alla Lika Ls Ga CEL 


2 
o, i b> fa 
| AWeeessie\ Eeensize? 
S) 


| 
) >» 
S ~) S52? 
7draw body & root | =% 
c) opname:- 


y pe 
terminallisY 


CCC 






0a CC€ 


¢ 
€ 


[ao | 
i J 9 
cc 
ces 
cect 
Ccecceec dy 
iy 
Q 


os 
¢, 
c 


© = 
iA, o 
M0 VT 04399399996 : 
C7 


(a4 
meee cee cegcceccceese® 


Y e 
4 
Cha tib6bdeatatihsttid§hatisshatiha 
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ZZ20FQLCanvas/drawobj 2:2draw Primative & UserOpr 1:ldraw body © root 1:2 





LL th ha tibddatitsbstifidstssst 
e 


10 che be 
f ~~, §1 
Y4FrameRoundARecYy 
oe Z(in)Z 


“Cee 
Clee 
C¢ 
c 
WMkeK ccc: I 
Ce 
¢ 


4 c< 
x 4} 0 x 
rootrecy 


43999292997 





4 FrameOvaiZ 


SULMMM EAE EAMES MAA ASA SATS. 


§1. (DISPLAY SDISPLAY) 





ZZ0FQLCanvas/drawobj 2:2draw Primative & UserOpr 1:) draw body © root 2:2 





LLL hi Late tifstshstutathifetif{sahts 





draw DISPLAY or SOISPLAY 





Z20FQtCanvas/invert 1:1 










Inverts the color of an object if 
the object is selected. 

Uses an inset first so thal the 
corners of the object remain to 


yinvertRoundRecY 


SUEAMMAMMAMMMIAMMM IIMA MIME 4s. 








ZZ0FQLCanvas/delete 1:1 





UZ deletem 4] 


2 Executed in response to the 


Gdbobjlisy Delete menu item. Goes through 






gdbobdjlist and deletes all selected 
~ objects. After deletions redraws 
i ° g the canvas and then turns off the 


Zlidodrawal Z select option. 


OOZ LLL Lah 
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—r— 





Z730FQLCanvas/delete 1:1deletem 1:2 





MQLhkk Ma hi hihahgbddatshahr bihddat a 


<<DFOLCanvas>> J 
selected 4 


co® 
a) 


Z20FQLCanvas/delete t:tdeletem 2:2 





Z220FQLCanvas/delete 1:1deletem 1:2doraot 1:1 





G-) 


— 
Rican santa) 
Ges 
0 








SLILELSELEDS SS LOSS SSSII APIS LEAS SA Ds 


Query Window Wed, May 20, 1992 6 35 PM 





ZQ0FQLCanvas/delete 1:ideletem 1:2doterms 1:1 





Qh hathdhatutitststdtahglstutsts 


: e - . {/ 
. : ee’. a e CClcree ° Y 
ores die Clee Cececeg gy 


cd 


“a 
e G9 
\ 


‘oe / 
SS Gees ie 




















Assumes that since 
we use find-instance 


Ps 7) 
hanceniieae : (AR Assumes at least one root 
copy but on the original. , connection since we have a 
terminal that says it is connected 
Gs3=G6s: to this root. 


OL Le Laks tes bathshatadiha tahiti tasks 


§1. (Primitive UserOpr) 





CA0FQLCanvas/delete 1:ldeletem 1:2doterms 1:lrmuzeros 1:2 


EE 


0 [x] 
CE 








Z20FQLCanvas/delete 1:1 deletem 1:2doterms t:irmuzeros 2:2 


es aa 


ZZ30FQLCanvas/delete 1l:l1deletem 1:2doterms 1:1) fixrootlist 1:1 








QLLLLL Lihthabitthutipngsgusais 
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V0FQLCanvas/delete 1l:ideletem 1!:2doterms 1i:1fixrootlist 1:ickroots 1:2 





Z20FaLCanvas/delete 1l:ldeletem 1:2doterms It:tfixrootlist 1:1ckroots 2:2 


Z3DFQLCanvas/init line 1:1 


<<DFOLCanvas>> 





Z20FQLCanvas/centerrect 1:1 






Calculates the center point 
(noriz) of input rectangle. 
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Z2ZDFQLCanvas/myclick 1:1 


$ ae rec 


window Canvas point 


[satis enangea™y 












>) 


~ 
oO wv * e 2, 
; Y, an) 
| create if input box exist 399 ffhandle click 


The contents of the window 1s changed when Clicked. 
Upon clicking, if there is a input box exists create 

a gdbobj according to the text in the input box before 
handling the click. 





OLLL ALL hahah hha tstbhst1de 





ZADFQLCanvas/myclick 1:1set file changed? 1:1 





SAMAASAOEOEESESISL LA AEADESAA Pf So ASG Is 


Z2ZDFQLCanvas/myclick I:lcreate if input box exist 1:1 








ZZ0FQLCanvas/handle click 1:5 








Ltkbitsietifitstiddiglatde 






Query Object 


Handles clicks on the BODY of 
gdbody objects. 


LZaomaincicn 


CALL Litidathdhadhetstdhsthdts baddded 
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Z320FQLCanvas/handle click 2:5 







Esermene Ax) 


term #) 









instnum 


2. C) CO C) 
{ dotermclick 7} 


Ciick on a terminal (input node). 


CMM hh thhahshdbddadddhbaditidata ee 





Z3A0FaLCanvas/handle click 3:5 






LLL Li Lap 
event rec 






[fF dorootcnck 4 


Handies click ifona 
root (output node). 








Z320FQLCanvas/handle click 4:5 





Handle click on the 
input bar. (From add user 
operator state.) 


SEISASSSLSLSIPA ELLA LAER EELS ADA AbD A» 





ZZ0FQLCanvas/handle click 5:5 





canvas Jpoint event rec 











( locate inoutbox ] 


If drawLineOn is true then just terminate this method. Esle, 
if a generic operator exists, create a gdbob) according to 
the text in the input box Then create another generic operator. 


CLL Lh he ahaa Litibatihdbatshite bbb 


Query Window Wed, May 20, 1992 6.36 PM 





Z30FQLCanuas/handle click !:Smainclick? 1:1 









If click was NOT on the BODY 
of an object, FAIL this case. 







SS 


ytind-bound Y 


a index gdbobj 
0g 





Z20FQLCanuvas/handile click !:S5domainclick 1:4 





oe; ) Ci 
f redrawob}-4 


This case is to drag the gdbobj. 





CLM LLL Lh a hhh hhh hs dsb hs baba 





C220FQLCanvas/handle click 1:Sdomainclick 2:4 









Case to select an object. 
Updates selected? and inverts 
color of object. 


CLLAZIIA LLL LL LaLa LLL 


Gi 


gdbobjlisf 
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ZZ0FQLCanvas/handle click 1:Sdomainclick 3:4 


canvaspoint ev fec 





(Mh hibibatuddtetitstatdbdbashe 


ZZ20FQLCanvas/handle click 1:5domainclick 4:4 






point ev rec 





canvas 








fupdategdbtex 


CALL hhh hatiddhetihitelatihnr 





ZZ0FQLCanvas/handle click 2:S5termclick? 1:1 





= eos) — @ 
doonlyoos 7 
@ 


(instnum its nth terminal #) 


ec¢ NULL 'G) 


FAIL case unless click 
was on a terminal 
(input node). 











LikaLs LLL 
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Z20FQtCanvas/handle click 2:5dotermclick 1:2 











canvas (instnum  term®#) 


(mec eal 


update terminallist 


hd 
Vv 
ww . 
: gdbobj rectmsinum connecied to) 
F< cd ? 


a “3 


drawLineOry 3 

\ Ua 7 Gictattanee 

at GG 
| LX 


center point 


So 





we. Wcpoveine 7 
Eseries], fe 


Ylrubberby 


(7 if not click on root then drawLineOn = FALSE ! 


Start with drawLinOn off. Turn it on. Remove any path from terminal. 
Delete any line from term. {nitialize to hook up a new line. 


CLL Le ilathatit5ihets6dshetsitha tatsde 





CZA0FQLCanvas/handle click 2:5Sdotermclick 2:2 


CZLIZZLLLLALLLLLL) 
canvas = 





R ram Eee (instnum — term#) 
ee Jgdbodjtiss jlisf 

\\ Pastate lemmas 

» startp ty 


Uilibedrawlin eg 


G 
G 
Ne 
& 
nd 
G 
O 


‘ ! 
Zilinitlingpseeseeee—" 


Update terminallist and redrawiines. 


Tad tc rootist 7] 


COLL Lhe hhh tathhhsatutdts tad 





ZA0FQLCanvas/handle click 3:S5rootclick? 1:1 








Query Window Wed, May 20, 1992 6:36 PM 





Z20FQLCanvas/handle click 3:5dorootclick 1:3 


VallVGS,pi.ovelu CC IU A, He Dtiiulil 





c 
gos 


A e rae 
{2 makeinfo: ley 
GE 






. If double clicked in a root display Information. 


(Lh hadatsbatddthatshstahdssdatshe 








ZA0FQLCanvas/handle click 3:5dorootclick 2:3 





canvas index Insinum 


| wati until mouseUo | 













if nof click on ferminal fhen drawLineOn = FALSE 








CMa ladstetituhatstiduhahsts tsb 
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Z3Z0FQLCanvas/handle click 3:Sdorootclick 3:3 





LLL fatddifutitiqgtitity4tsth 


instnum 







index 


Ygdbobjlis¥ 


{ update terminallist & rootlist 4) 


COZZI LL Lah hha LAL 





Z3A20FQLCanuvas/handle click 4:Sinputbarclick 1:1 





CLL Laks habs tdbhbpstihdhatshtds daha 
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ZODFQLCanvas/handle click 4:Sdoinputbarctick 1:1 


point event rec 
MMMM MMA MMMM AL MMMM ML 


° {0 0 0 0} 


CText Object 5 





gdbobjlis¥ 


Ylidrawinnode Z 


| Lik hi Mh hd batbbhdhatd5bshsddib5tgddeakd 


Z320FQLCanvas/handle click 5:SdrawLineDn? 14:1 


(eh eee 


canvas 


lines 






TRUE (x) 


CLL LL Lh hha dah tsbbhatstits bahar 












Z2AD0FQLCanvas/handle click 5:Slocate inputbox 1:1 





CLL La Lidhatstststetshatipddiatalihe 





ZAZ0FQLCanvas/handle click 1:Sdomainclick 1:4dodrag 1:1 





new rect old rect 


Query Window Wed, May 20, 1992 6:36 PM 





Z2Z0FQLCanvas/handle click 1:5domainclick 1:4mouve to new location 1:1 





obiec! 





Z20FQLCanvas/handle click 1:5domainclick 1:4redrawobj 1:1 


' ; Vas 
<<DFOLCanvas>: - roel 














y 
Y] 


find adbabis within region | 


C3 


Cc e s) 


SE 
Z 
redraw i 


“hh dddddddd adh ddd dlddddlddd dd ets. 





ZZA0FQtLCanvas/handle click 1:Sdomainclick 2:4invert opr 1:1 








N 


(/ j 
sc-begin-drawingZ 








YinsetRectZ 


y-IinvertRoundRecY 


ULL data tspslphibbdattithsattlsitadde 





ZA0FQLCanvas/handle click 1:Sdomainclick 1:4move to new location 1:1set new location 1:1 













pias 
UP getottset | 


eset new location | 
eo 
& 


OL LLL AL Liha habathihetihpihststikdr 


Query Window Wed, May 20, 1992 6:36 PM 


Z20FQLCanvas/handle click 1:Sdomainctick 1:4move to new location 1:lset new location t:igetoffset 1:1 


ODODE. KZ). 





| Z20FQLCanuas/handle click 1:5domainclick 1:4move to new location l:lset new location Il:1set new location 1:1 
| LLL Latha i fbda Lid hha hb 












Y OtfsetRecy4 








Query Window Wed, May 20, 1992 6:36 PM 





Z20FQLCanuas/handle click 1:3domainclick 1:4redrawobj I:tfind gdbobjs within region 2:2 


CLL LLL LL 
CIOL 








Z20FQLCanuas/handle click 1:Sdomainclick 1:4redrawobj t:!redraw 1:1 





CLL MMe hahihgtstiheahdtststits hah 


ZA0FQLCanvas/handle click 2:S5termclick? 1:!doonlyops 1:2 


MLL, ete hihi titi lLiLs 
e 


pt 
6 gdbob) 


Zity peZ 


C 5 5) 
Text Object (v? 






cterminallis 


ZpackZ 0 x 


{instnum its nth terminal #) 


Z20FQLCanvas/handle click 2:S5termclick? I:!doonlyops 2:2 


CLA LE 


pt 
(0 0) 


Query Window Wed, May 20, 1992 6:36 PM 


Z320FQLCanvas/handle click 2:S5termclick? 1:ldoontyops I:2checkterms 1:2 





Z20FQLCanuvas/handle click 2:5Sdotermclick l:2wati until mouseUp 1:1 


LLL LLL LLL LL dhhakd 





TRUE (x) 


CLL Le Lith ha bihihetiddhatshdhatitadkar 





Z20FQLCanvas/handle click 2:Sdotermclick 1:2update terminallist 1:1 





<<DFOLCanvas>> a 


(instnum = term#) 





index gdbob}; list 


Query Window Wed, May 20, 1992 6.37 PM 





Z20FQLCanvas/handle click 2:5dotermclick 1:2set lines 1:1 





CLL hha hhdhahsgtitihstspitatsdsha tr 





ZB0FQLCanvas/handle click 2:5dotermclick 1:2removeline 1:1 





instnum (connected to) 
LLSLAAA ASDA ALISA ALAS ES ddA LAG AL 
C) () C) (J 


nein {(instnum term#) 
<<DFOLCanvas>> 


=f 
R554 be - lv) 
gdbobjlisf 


instnum 
eS 
— Sa 
Ztind-instanc@ 
hs 
be e, 
IN [Eupoate roons'] 
4 


oe 
i 4 
YZ eraseline Z| 












C) C) ) 
& 
idrawrtconnect ¥ 


o 
oy, & is) 2, 
tidodrawalY 


CLLahishbhetstietatitetatibdbstsditade 


Query Window Wed, May 20, 1992 6:37 PM 
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° Takes the one that was selected 
- and displays it in the View 
NULL User Operator -- window. 
Concatenales the name of the 
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for the operator (gelopname) and the 

help message for it (gethelptext) from 
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